home *** CD-ROM | disk | FTP | other *** search
/ Network Supervisor's Toolkit / Network Supervisor's Toolkit.iso / administ / lantools / lantools.doc next >
Text File  |  1996-07-10  |  43KB  |  965 lines

  1.                          Devont Software's
  2.                        LANTools Version 2.21
  3.                             May 3, 1991
  4.  
  5.                          ╒══════════════╕
  6.                          │ Introduction │
  7.                          ╘══════════════╛
  8. As a Systems Administrator or one who creates networks for a
  9. living, you probably already know that the glue that holds these
  10. complex systems together is the little Batch files and utilities.
  11. Devont Software's LANTools is a collection of such utilities
  12. designed to make your life a little easier.
  13.  
  14.                          ╒══════════════╕
  15.                          │ Requirements │
  16.                          ╘══════════════╛
  17. Most of the functions in LANTools operate directly with the Novell
  18. Bindery information.  Because of this integration with Netware,
  19. LANTools will not work on any other network type, or on stand-alone
  20. machines.  Besides that small requirement, you should have the
  21. following resources available:
  22.  
  23.  
  24. √    IBM Personal Computer or Compatible.
  25.  
  26. √    256K RAM Free or more
  27.  
  28. √    VGA, EGA, CGA, Mono, or Hercules Monitors are supported
  29.  
  30. √    Novell Netware 2.1x and above, or ELS versions (versions below
  31.      2.1x may not support the printing functions)
  32.  
  33.                    ╒══════════════════════════╕
  34.                    │ Registration and Support │
  35.                    ╘══════════════════════════╛
  36. LANTools is not free software.  If is not and will never be in the
  37. public domain.  You are granted a limited license to test the program
  38. to see if it fits in your environment.  If you use any of the utilities
  39. contained in this package after a 30 day trial period, you need to
  40. support our development efforts by sending a check or money order
  41. for $75.00 per site in US Funds to:
  42.  
  43.                          Devont Software
  44.                            85 Brandon
  45.                        Conroe, Texas 77302
  46.                       BBS - (409) 273-3112
  47.                         CIS: 70421,1506
  48.  
  49. Technical support and upgrades are available by calling our Technical
  50. Support Bulletin Board (BBS).  We are open 24 hours a day, 7 days a
  51. week, and support 300-2400bps.  We would like to hear from you if you
  52. have any suggestions, improvement ideas, customization requests or
  53. complaints.  We take them all.  You can call our tech support
  54. telephone number between the hours of 7pm and 10pm CST.  We would like
  55. to hear from you.  (409) 321-3220.  Weekends from noon to 7pm CST.
  56.  
  57.                           ╒═════════════╕
  58.                           │ Conventions │
  59.                           ╘═════════════╛
  60. In the functional descriptions below, the following conventions are
  61. used:
  62.  
  63. [option]       Options enclosed in brackets are optional.
  64. /x=            Lettered options are required parameters.
  65. FILESPEC       Any file specification, such as *.EXE, z:\joe.txt
  66. FILE.EXT       Any valid Filename, such as z:\public\joe.txt
  67.  
  68.  
  69.                          ╒═════════════════╕
  70.                          │ LANTools Attach │
  71.                          ╘═════════════════╛
  72.  
  73. Description:   LANTools Attach is functionally equivalent to Netware's
  74.                ATTACH command, with the major difference in that
  75.                the interface is much prettier.  Users can select a
  76.                file server that is not already attached by using a
  77.                bouncebar menu.  Attach prompts the user for
  78.                required information, and tells them whether the
  79.                attachment was successful.
  80.  
  81. Use:           LANTools Attach [/q]
  82.  
  83. Parameters
  84.  
  85. /q             Use "Quiet Mode."  Do not clear the screen after
  86.                the program has completed.
  87.  
  88. /c             (Color - Optional) Select a color from 1 -4
  89.  
  90.  
  91.                    ╒══════════════════════════╕
  92.                    │ LANTools Bulletin Master │
  93.                    ╘══════════════════════════╛
  94.  
  95. Description:   LANTools BBS allows the system administrator to set
  96.                up ASCII text files, then display them to particular
  97.                groups of users upon login, or from a menu item.
  98.                Using this feature, you can notify your users of any
  99.                events, procedures, or policies.
  100.  
  101.                If you specify multiple text files, BBS will
  102.                display a bouncebar menu of available bulletins,
  103.                and will allow the user to point and shoot the
  104.                bulletins he wants to read.
  105.  
  106. Use:           BBS /f=FILESPEC [/g=GROUP,GROUP,GROUP] [/q]
  107.  
  108. Example:       LANTools BBS /f=z:*.bbs /g=ADMIN,TECH
  109.  
  110. Parameters
  111.  
  112. /f             (Filespec - Required)  Can be any filename, or group
  113.                of files. You can add any fully qualified pathname, one
  114.                filename, etc.
  115.  
  116. /g             (Groups - Optional)  BBS will check to see that the user
  117.                running the program is a member of this group (or
  118.                several groups separated by a comma) if this
  119.                optional parameter is used.  If you do not specify
  120.                a group, BBS will assume EVERYONE can read the
  121.                bulletins specified.
  122.  
  123. /q             (Quiet Mode - optional):  Do not display any message
  124.                if no bulletin files are available.
  125.  
  126. /c             (Color - Optional) Select a color from 1 -4
  127.  
  128.  
  129. Text File      When creating a text file for display in BBS, the
  130.   Notes        very first line can contain a title.   To display
  131.                the title when multiple text files are available,
  132.                use the following format:
  133.  
  134.                ^^This is the Title^^
  135.                ..Rest of ASCII text file
  136.  
  137.                             ╒══════════════════╕
  138.                             │ LANTools Capture │
  139.                             ╘══════════════════╛
  140.  
  141. Description:   LANTools Capture is functionally equivalent to
  142.                Netware's CAPTURE command.  With LANTools Capture,
  143.                you can redirect your LPT1-4's output to any
  144.                defined network queue, or end a capture session,
  145.                and return print operations to a local printer.
  146.                Capture does all this with complete error checking
  147.                and friendly interfacing.
  148.  
  149.                If you are attached to multiple servers (via
  150.                Netware's ATTACH or LANTools' ATTACH command), you
  151.                can press the <Spacebar> while viewing the Print
  152.                Queue listing to change to the next server.  You can
  153.                then capture to a queue on another server.
  154.  
  155. Use:           LANTools Capture [/q]
  156.  
  157. Parameters:
  158.  
  159. /q             (Quiet Mode - optional):  Do not clear the screen
  160.                when the program completes.
  161.  
  162. /c             (Color - Optional) Select a color from 1 -4
  163.  
  164.  
  165.                             ╒═══════════════════╕
  166.                             │ LANTools ChangePW │
  167.                             ╘═══════════════════╛
  168.  
  169. Use:           LANTools ChangePW USERID NEW_PASS_WORD
  170.  
  171. Parameters:
  172.  
  173. USERID         User ID to Change
  174. NEWPASSWORD    New Password
  175.  
  176.                             ╒════════════════════╕
  177.                             │ LANTools CheckPass │
  178.                             ╘════════════════════╛
  179.  
  180. Description:   LANTools CheckPass is a simple utility that allows you to
  181.                prompt the user for a password.  If the correct password
  182.                is entered, a DOS ERRORLEVEL of 1 is returned.  Incorrect
  183.                passwords return a DOS ERRORLEVEL of 0.
  184.  
  185. Parameters:
  186.  
  187. /p=Password    (Required Parameter):  This parameter tells CheckPass what
  188.                the correct password is.  Not case sensitive.
  189.  
  190. /c              (Color - Optional) Select a color from 1 - 4.
  191.  
  192. /q              (Quiet Mode - Optional):  Do not clear the screen when the
  193.                 program completes.
  194.  
  195.  
  196.                            ╒═══════════════════╕
  197.                            │ LANTools DefaultQ │
  198.                            ╘═══════════════════╛
  199.  
  200. Description:   LANTools Default-Q allows you to set up default print
  201.                queues for each user, then automatically cature to
  202.                that queue upon login or any other time.
  203.  
  204.                DefaultQ uses the same parameters as Novell's CAPTURE
  205.                program to change the settings of the current Capture
  206.                setting, but using the queue that the Supervisor or
  207.                user has set up.
  208.  
  209.                The unique parameters to DefaultQ are /C and /U.
  210.  
  211.                /c = Configure DefaultQ
  212.                /u = Un-Install DefaultQ
  213.  
  214. RETURNS        If used as a CAPTURE command, DOS ERRORLEVEL 1 is
  215.                returned if the capture environment is not changed -
  216.                some kind of error occurred. Otherwise, ERRORLEVEL 0
  217.                is returned if everything is successful.
  218.  
  219.                You can test this ERRORLEVEL in a batch file such as:
  220.  
  221.                @echo off
  222.                LANTools DefaultQ /nb /nff /ti=10
  223.                IF ERRORLEVEL 1 goto ERROR
  224.                goto EXIT
  225.                :ERROR
  226.                LANTools Message /m="Network Printer Not Selected"
  227.                :EXIT
  228.  
  229. Use:   LANTools DefaultQ  [/c] [/u] [ /b=BannerTxt /nb /ff /nff /ti=n ... ]
  230.  
  231.  
  232. PARAMETERS      /c  Configure DefaultQ
  233.  
  234.                 /u  Uninstall DefaultQ
  235.  
  236.                 Other Parameters supported are the same as Novell's CAPTURE
  237.                 command, such as /b=BannerText, /nb, /ti=3, /nff (etc.)
  238.  
  239.  
  240.                                 Why Use DefaultQ
  241.  
  242. Let's say you are running a network with about 20 printers, and 50 users.
  243. If you would like to automatically run a CAPTURE statement on each user
  244. in the login process, you have roughly four choices:
  245.  
  246. 1.  Create a User Login Script and run the #CAPTURE statement.  This is
  247.     fine for smaller networks, but who wants to maintain all those user
  248.     Login Scripts?  It's usually a good idea to avoid using them if at
  249.     all possible.
  250.  
  251. 2.  Allow the user to create his own personal print queue and defaults
  252.     using the PRINTCON program.  This is a good way to do it, but who
  253.     wants to explain the inner workings of the Netware print services
  254.     and/or print options to a legal secretary?  You'd probably end up
  255.     creating a bunch of them yourself, or copying the same definition
  256.     from one user to the other, limiting the customizability, and in
  257.     the end you'll have to edit all these over again someday when they
  258.     move down the hall to a new office.
  259.  
  260. 3.  Create a Group the same name as the name of the print queue, then
  261.     make all the users who need to print to that printer a member of this
  262.     new group.  You could then test for membership to the printer groups
  263.     in the login script, and do some nifty branching.  Well, again, if
  264.     you have 20 printers, that's an extra 20 groups, and 20 different
  265.     tests in the System Login script you'd have to make to see which
  266.     group they are a member of....not to mention the chance for errors
  267.     in putting all the right users in all the right places.
  268.  
  269. 4.  You could create a file, add all the UserIDs and their default print
  270.     queue next to it, then write a simple program that looks at the
  271.     file one entry at a time, reads the name, the print queue, and then
  272.     does something fancy to actually call the CAPTURE routines in
  273.     Netware.  Big pain.  Plus, you've then got a file to maintain.
  274.  
  275.  
  276.                           How Does DefaultQ Work?
  277.  
  278. DefaultQ uses standard Netware services to write to the user data file,
  279. known as the Bindery.  DefaultQ stores one vital peice of information
  280. next to the user account property:  The default print name that either
  281. you or he set up.  If DefaultQ has never been configured for a particular
  282. user, then nothing is written to that user account.
  283.  
  284. After DefaultQ has been set up for a user, they can execute the
  285. DefaultQ command. The program picks up the name of the default print
  286. queue, any valid CAPTURE parameters entered along with the basic command,
  287. then again uses standard Netware services to create the CAPTURE environment.
  288.  
  289. If DefultQ has not been set up for a user and it is run like a CAPTURE
  290. command, a DOS ERRORLEVEL 0 is returned, and the CAPTURE environment is
  291. not affected.
  292.  
  293.  
  294.  
  295.  
  296.                            ╒═══════════════════╕
  297.                            │ LANTools IsMember │
  298.                            ╘═══════════════════╛
  299.  
  300. Description:   LANTools IsMember is a batch file enhancer.  This
  301.                utility allows you to determine if a user is a
  302.                member of a particular group.  LANTools IsMember
  303.                returns a DOS ERRORLEVEL that you can test and
  304.                perform conditional branching.
  305.  
  306. Use:           LANTools IsMember /g=GROUP1,GROUP2
  307.  
  308. Parameters:
  309.  
  310. /g             (Group(s) - Required) Specify the group (or groups
  311.                separated with a comma) to check.
  312.  
  313. /q             (Quiet Mode - optional):  Do not clear the screen
  314.                when the program completes.
  315.  
  316. /c             (Color - Optional) Select a color from 1 -4
  317.  
  318. Returns:       ERRORLEVEL 1 = User is a member of at least one of the
  319.                specified groups.
  320.  
  321.                ERRORLEVEL 0 = User is NOT a member of at least one of the
  322.                specified group(s).
  323.  
  324.  
  325.                             ╒═══════════════╕
  326.                             │ LANTools List │
  327.                             ╘═══════════════╛
  328.  
  329. Description:   LANTools List is a simple file viewer for ASCII
  330.                text files.  I'm sure you have seen programs like
  331.                LIST, BROWSE, or maybe you have written your own.
  332.                This program is a simple version of those, but in a
  333.                form that even the most computer-illiterate users
  334.                can use without getting overly confused.  In
  335.                addition, this program follows the other LANTools
  336.                in the interface, giving your system a colorful,
  337.                fluid feel.
  338.  
  339. Use:           LANTools List [/f=FILE.EXT] [/q] [/c=1-4]
  340.  
  341. Parameters
  342.  
  343. /f             (FileName - Optional Parameter): any valid file
  344.                name, such as Z:FRED.TXT.  If the file does not
  345.                exist, a message displays.  Note also the text file
  346.                to display is limited to 64K.  If a filename is
  347.                not specified, you are prompted to enter one.
  348.  
  349. /q             (Quiet Mode - optional):  Do not clear the screen
  350.                when the program finishes.
  351.  
  352. /c             (Color - Optional) Select a color from 1 -4
  353.  
  354.                                 ╒═══════════════╕
  355.                                 │ LANTools Lock │
  356.                                 ╘═══════════════╛
  357.  
  358. Description:   LANTools Lock allows you to lock your computer
  359.                while you are away at lunch or away from your desk.
  360.                You can display a brief message to those who come
  361.                to your desk and look at your screen.  Lock also
  362.                comes with a screen blanker that will activate
  363.                after a period of about 5 minutes.  Pressing a key
  364.                while the blanker is in effect restores the screen.
  365.  
  366. Use:           LANTools Lock [/m="Message Text"] [/p] [/q]
  367.  
  368. Parameters:
  369.  
  370. /m             (Message Text - Optional) Message to display when
  371.                your machine is locked.  If this parameter is not
  372.                specified, you will be prompted to enter this
  373.                information.
  374.  
  375. /p             (Password - Optional)  Password that will be used
  376.                to unlock your keyboard.  If you do not specify
  377.                this parameter, you will be prompted to enter this
  378.                information.  Maximum password length is 8 characters.
  379.  
  380. /q             (Quiet Mode - Optional) do not clear the screen
  381.                when the program has completed.
  382.  
  383. /c             (Color - Optional) Select a color from 1 -4
  384.  
  385.                                ╒═════════════════╕
  386.                                │ LANTools Logout │
  387.                                ╘═════════════════╛
  388.  
  389. Description:   LANTools Logout is functionally equivalent to
  390.                Netware's LOGOUT.EXE.  The difference is in the
  391.                interface. LANTools Logout allows you to prompt the
  392.                user with a colorful message, then reboot
  393.                (optionally) the machine when a specified time
  394.                period, or press of the enter key has been
  395.                performed.
  396.  
  397.  
  398. Use:           LANTools LOGOUT [/m="MESSAGE TEXT"] [/w=n] [/r] [/q]
  399.  
  400. Parameters
  401.  
  402. /m             (Message Text - Optional): Use this parameter if you
  403.                would like to display a message to the user after he
  404.                has logged out.  Note that when specifying a message,
  405.                you must use the " marks surrounding the message
  406.                text.  If you do not specify a message, a generic
  407.                "You Have Been Logged Out" displays.
  408.  
  409.                You can place a carat (^) in your text to display
  410.                two lines of text to the user.  For instance:
  411.                LANTools Logout /m="You Are logged out^Thank You!"
  412.  
  413.                You are limited to displaying two lines of text.
  414.                Each line of text can contain up to 60 characters.
  415.  
  416. /w             (Wait time - Optional):  Amount of time to wait before
  417.                ending the program.  If not specified, 0 is assumed, which
  418.                means to wait until <Enter> is pressed.
  419.  
  420. /r             (Reboot - Optional): Reboot the computer when the
  421.                program completes.
  422.  
  423. /q             (Quiet Mode - Optional):  Do not clear the screen when
  424.                the program is finished.
  425.  
  426. /c             (Color - Optional) Select a color from 1 -4
  427.  
  428.                                    ╒═══════════════╕
  429.                                    │ LANTools Menu │
  430.                                    ╘═══════════════╛
  431.  
  432. Description:  LANTools Menu is a simple menu builder.  You can create
  433.               a standard ASCII text file, and Menu will display the
  434.               menu items in a formatted screen.
  435.  
  436.  
  437. Use:          LANTools Menu /f=FileSpec [/c=1-4] [/q]
  438.  
  439. Returns:      DOS Errorlevel (0=ESC was pressed, 1=Item 1, 2=Item 2...)
  440.  
  441. Paramters
  442.  
  443. /f            Menu File Name to read.  Example:  LANTools Menu /f=MENU.TXT
  444.  
  445.               << Contents of MENU.TXT >>
  446.  
  447.               File Management
  448.               Logout of Network
  449.               Accounting Functions
  450.               Send a Message
  451.               Select Network Printer
  452.               Attach to File Server
  453.  
  454.               If the example file above was used, the DOS ERRORLEVEL returned
  455.               would be as follows:
  456.  
  457.               0 - No Selection was made.
  458.               1 - File Management
  459.               2 - Logout
  460.               3 - Accounting
  461.               4 - Send a Message
  462.               5 - Select Network Printer
  463.               6 - Attach to File Server
  464.  
  465.               You can process this ERRORLEVEL in a batch file.  For more
  466.               information about DOS ERRORLEVELs and batch files, please
  467.               see your handy-dandy DOS manual.  Also see SAMPLE.BAT for
  468.               an example of LANTools Menu.
  469.  
  470.  
  471. /c            Color for Menu.  1-4 are accepted
  472.  
  473. /q            Do not clear the screen when finished.
  474.  
  475.  
  476.                                  ╒══════════════════╕
  477.                                  │ LANTools Message │
  478.                                  ╘══════════════════╛
  479.  
  480. Description:   LANTools Message is a simple utility that allows
  481.                you to display messages to your users in a
  482.                formatted, consistent and colorful way.  Users
  483.                do not need to have ANSI.SYS loaded, nor do you
  484.                have to check for monitor type.
  485.  
  486. Use:           LANTools Message /m="Message Text" [/w=n] [/q]
  487.  
  488. Parameters
  489.  
  490. /m             (Message Text - Required):  This parameter tells
  491.                LANTools Message what to display.  Note that the
  492.                message text must be surrounded by the quotation
  493.                (") marks.
  494.  
  495.                You can place a carat (^) in your text to tell Message
  496.                to break the text into two lines.  For instance:
  497.                LANTools Message /m="Hello There^Welcome Aboard"
  498.  
  499.                You are limited to displaying two lines of text.
  500.                Each line of text is limited to 60 characters.
  501.  
  502. /w             (Wait Time - Optional):  Tells LANTools Message how
  503.                long to wait before ending the program.  If you do
  504.                not specify a parameter, 0 is assumed, which means
  505.                to wait until <Enter> is pressed.
  506.  
  507. /q             (Quiet Mode - Optional):  Do not clear the screen
  508.                after the program ends.
  509.  
  510. /c             (Color - Optional) Select a color from 1 -4
  511.  
  512.                                ╒═══════════════════╕
  513.                                │ LANTools Password │
  514.                                ╘═══════════════════╛
  515.  
  516. Description:   LANTools Password is functionally equivalent to Netware's
  517.                SETPASS command.  It allows your users to change their
  518.                login password.  Difference is in the interface, and that
  519.                you can select to log the password to a text file.
  520.  
  521.                Run without parameters, PASSWORD checks to see if the user's
  522.                password is about to expire (within 3 days).  If so, the
  523.                user is prompted to enter his old and new password.  If
  524.                correct, the user's password is changed at the file server.
  525.  
  526.                If the /l=LOG parameter is used, PASSWORD writes all
  527.                password activity to a file called PW.LOG in the current
  528.                directory.  Be careful!  This feature is not meant for
  529.                any other reason than for the systems administrator to
  530.                track and document passwords used on his/her system.
  531.                Letting the PW.LOG file into the wrong hands, and your
  532.                system security will go down the drain.
  533.  
  534. Use:           LANTools Password [/f] [/l=FILE.EXT]
  535.  
  536.  
  537. Parameters
  538.  
  539. /f             "Force" the password change.  This could be used as a menu
  540.                selection item, so the users can change their password
  541.                whenever they want to. Without this parameter, PASSWORD
  542.                checks to see if the user's password is almost expired.
  543.                If not, the program ends.
  544.  
  545. /l             Log all password change activity into the specified file.
  546.                For example:  LANTools Password /f /l=f:\dat\pw.dat
  547.  
  548.                Note:  You should Hide the directory that contains the
  549.                password log file to keep prying eyes out of it.  Also,
  550.                remember that the users must have Write, Modify, Read
  551.                and Open rights to this directory.  If the file does
  552.                not already exist, they must also have Create rights.
  553.  
  554.                Example Rights for directory that contains pw log file:
  555.  
  556.                Netware 386 - [ R W M F   ]
  557.                Netware 286 - [ R W M O S ]
  558.  
  559.  
  560.                                  ╒═══════════════╕
  561.                                  │ LANTools Send │
  562.                                  ╘═══════════════╛
  563.  
  564. Description:   LANTools Send is functionally equivalent to
  565.                Netware's SEND.EXE.  With LANTools Send, however,
  566.                the user interface is quite a bit more friendly and
  567.                colorful.
  568.  
  569.                If you are attached to multiple servers (via Netware's
  570.                ATTACH or LANTools' ATTACH command), you can send
  571.                messages to users on other servers by using the
  572.                <Spacebar> while viewing the user list.
  573.  
  574. Use:           LANTools Send [/q]
  575.  
  576. Parameters
  577.  
  578. /q             (Quiet Mode - Optional) Do not clear the screen
  579.                after the program ends.
  580.  
  581. /c             (Color - Optional) Select a color from 1 -4
  582.  
  583.                               ╒══════════════════╕
  584.                               │ LANTools TimeOut │
  585.                               ╘══════════════════╛
  586.  
  587. Description:   LANTools TimeOut is a program that waits until a
  588.                specified time is reached, then returns a DOS
  589.                ERRORLEVEL.  The program can be aborted by entering
  590.                in a specified password, which then a different DOS
  591.                ERRORLEVEL is returned.  This returned value can be
  592.                tested in a batch file.  A common use for this
  593.                utility is in Automated Tape procedures, such as
  594.                performing an automatic backup at 02:00.
  595.  
  596.                << Example TAPE.BAT >>
  597.  
  598.                @echo off
  599.                cls
  600.                :LOOP
  601.                LANTools TimeOut /t=02:00 /p=wierd
  602.                if errorlevel 1 goto TAPE
  603.                if errorlevel 0 goto EXIT
  604.                :TAPE
  605.                tna2tape /a /q
  606.                goto LOOP
  607.                :EXIT
  608.  
  609.  
  610. Use:           LANTools TimeOut [/t=HH:MM] [/p=xxxxxxx]
  611.  
  612. Parameters
  613.  
  614. /t             (Time - Optional)  If specified, this is the time
  615.                that must be reached in order for TimeOut to end.
  616.                If not specified, you will be prompted to enter
  617.                this information.  Note:  Use 24 Hour Military
  618.                time!
  619.  
  620. /p             (Password - Optional) If specified, this is the
  621.                password needed to abort the program.  If not
  622.                specified, you will be prompted for this
  623.                information.
  624.  
  625. /q             (Quiet Mode - Optional) Do not clear the screen
  626.                after this program ends.
  627.  
  628. /c             (Color - Optional) Select a color from 1 -4
  629.  
  630.          TimeOut Returns the following DOS ERRORLEVELS:
  631.                  1 = Time Reached.
  632.                  0 = Password Entered Correctly
  633.  
  634.                              ╒═════════════════╕
  635.                              │ LANTools WhoAmI │
  636.                              ╘═════════════════╛
  637.  
  638. Description:   LANTools WhoAmI provides an informational display
  639.                containing vital information about the user who
  640.                is running it.  Information such as the password
  641.                expiration date, connection number, ID number and
  642.                current print queue selected is displayed in a
  643.                nice box in the middle of the screen.  The user
  644.                cannot change any of this information within this
  645.                function.
  646.  
  647. Use:           LANTools WhoAmI [/q] [/c=1]
  648.  
  649. Parameters
  650.  
  651. /c             (Color - Optional) Specify a color from 1 - 4
  652.  
  653. /q             (Quiet Mode - Optional) Do not clear the screen when
  654.                this function ends.
  655.  
  656.  
  657.  
  658.                              ╒═════════════════╕
  659.                              │ LANTools YesBox │
  660.                              ╘═════════════════╛
  661.  
  662. Description:   LANTools YesBox is another batch file enhancer.
  663.                With YesBox, you can place a message on the screen,
  664.                and have the user respond with the up or down arrow
  665.                keys to select either "Yes" or "No". Depending on
  666.                what the user selects, a DOS ERRORLEVEL is
  667.                returned.  This returned value can be tested in a
  668.                batch file for conditional branching.  You probably
  669.                have a utility that does this for you already, but
  670.                not as friendly and colorful as this one is!
  671.  
  672.                The user cannot break out of this prompt.  The only
  673.                valid keys while in this function are the Up and
  674.                Down arrow keys, and <Enter>.
  675.  
  676. Use:           LANTools YesBox [/m="Message Text"] [/q]
  677.  
  678. Parameters
  679.  
  680. /m             (Message Text - Optional)  Whatever text you
  681.                specify in this parameter will be used as the title
  682.                for the yes/no box.  If you do not specify a
  683.                parameter for this function, "Are You Sure" will be
  684.                used.  Note that you must surround your text with
  685.                quotation (") marks, and are limited to 40
  686.                characters.
  687.  
  688. /q             (Quiet Mode - Optional)  Do not clear the screen
  689.                when the program ends.
  690.  
  691. /c             (Color - Optional) Select a color from 1 -4
  692.  
  693.       LANTools Yesbox Returns the following DOS ERRORLEVELS
  694.  
  695.                1 = The "Yes" option was selected.
  696.                2 = The "No" option was selected.
  697.  
  698.                               ╒═══════╕
  699.                               │ Notes │
  700.                               ╘═══════╛
  701.  
  702. We are planning the following enhancements to LANTools:
  703.  
  704. 1.   Rolodex/Address Manager tied to EEMail's databases.
  705. 2.   Map Assistant
  706. 3.   Send/Receive Files between users.
  707.  
  708. If you have any ideas for enhancements, please let us know!  While
  709. we're here, here's a plug:  Try Einstein Electronic Mail!  You can
  710. find it on CIS, or on our support BBS.  You'll find the same easy-to
  711. use functions in a professional, friendly electronic mail program for
  712. Novell Networks.
  713.  
  714.                             ╒══════════════════╕
  715.                             │ Revision History │
  716.                             ╘══════════════════╛
  717.  
  718. Date           Version   Description
  719. =========================================================================
  720. 05-03-91       1.0       Initial Release
  721. =========================================================================
  722. 05-04-91       1.01      Changes to .DOC to show /c options,
  723.                          /r=REBOOT in LOGOUT was missing in code.
  724. =========================================================================
  725. 05-07-91       1.02      Missing multiple group checking in IsMember.
  726.                          Added Online help when running LANTools without
  727.                          parameters.
  728. =========================================================================
  729. 05-10-91       1.03      SEND now shows users who are logged on.  Also
  730.                          added some information when a user is selected
  731.                          to send a message.
  732.  
  733.                          Fixed a bug in MESSAGE that converted the text to
  734.                          lower case, and added code to allow up to two
  735.                          lines in most /m options.
  736. =========================================================================
  737. 06-08-91       1.04      Fixed minor interface bugs.  You'll probably not
  738.                          notice most of them, but they bugged me.  For
  739.                          instance, when selecting a user in SEND, the
  740.                          light bar is returned to that user after the
  741.                          message is sent.  Same kinda thing for CAPTURE.
  742. =========================================================================
  743. 06-17-91       1.05      Another maintenance release.
  744.                          This release, we worked on the CAPTURE command.
  745.                          Now the user's previous capture flags are used
  746.                          and displayed.  You'll notice the extra screens
  747.                          when the program is executed.
  748.  
  749.                          Another minor one, the color parameters were ignored
  750.                          in SEND and CAPTURE.  This is fixed.  Still have
  751.                          to work on the colors for /c=2,3 and 4.  They're
  752.                          pretty ugly right now...
  753. =========================================================================
  754. 06-21-91       1.10      Added a new function, PASSWORD.  This allows you
  755.                          to test your user's password.  If it close to
  756.                          expiring (within 3 days), PASSWORD will prompt
  757.                          your users for their password, and change it in
  758.                          the bindery.  This function is the only reason
  759.                          I can think of right now to own a laptop.  Instead
  760.                          of staring at the walls waiting for a plane, I was
  761.                          able to get some work done.  Now if only I had
  762.                          a cellular modem...
  763.  
  764.                          Another new one, MENU, allows you to create
  765.                          a bounce-bar menu.  Supply the file name containing
  766.                          the menu items, and go.  Returns a DOS ERRORLEVEL
  767.                          depending on the item selected.
  768.  
  769.                          SEND was totally changed in this release.  Now you
  770.                          can send messages to groups.  More information
  771.                          and cleaner interface.
  772.  
  773.                          SEND and CAPTURE received a "Scroll Bar" function.
  774.                          This helps the user tell where he is in the list
  775.                          of things.
  776.  
  777.                          CAPTURE had an invalid maximum window length,
  778.                          which "shadowed out" the userid in the footer
  779.                          line if more than 11 print queues were available.
  780.  
  781.                          LIST was changed a bit.  If you do not specify
  782.                          a file name (/f=filespec) on the command line,
  783.                          LIST will prompt you for one.
  784.  
  785.                          This version has also changed the way users are
  786.                          prompted for their password in some functions.
  787.                          Now, TIMEOUT and LOCK display "*" instead of
  788.                          displaying the text of the password.
  789.  
  790.                          If a user does not enter a message text in LOCK,
  791.                          a default of "I Am Away From My Desk" is now used.
  792.  
  793.                          The SAMPLE.BAT changed to add new functions.
  794.                          Re-Run this again to see what's new.  Edit that
  795.                          batch file to see how you can interface this
  796.                          stuff...
  797. =========================================================================
  798. 06-24-91       1.11      Maintenance Release (so soon, you ask?)
  799.  
  800.                          Everyone bugged me about not verifying the NEW
  801.                          password in PASSWORD.  That's been corrected.
  802.                          The user is asked to enter his new password
  803.                          twice in this function.  Also changed some
  804.                          messages the user receives when something
  805.                          happens to clarify the situation.
  806.  
  807.                          The User Listing Window box in SEND was 2 lines
  808.                          too long.  Woops.  Should have looked at the
  809.                          code for CAPTURE, it was the exact same.
  810. =========================================================================
  811. 06-30-91       1.20      New Version 1.20
  812.  
  813.                          Added another new function, WhoAmI.  This
  814.                          is sorta like the WHOAMI.EXE program that Novell
  815.                          provides, just a little deeper.  Basically combines
  816.                          some of the functionality of the Account
  817.                          Restrictions in SysCon, WHOAMI's display, and
  818.                          some other extras...
  819.  
  820.                          LOCK received a screen blanker.  After an
  821.                          inactivity period of about 5 minutes, the
  822.                          screen will go blank, and a spinner will appear
  823.                          in the lower right corner of your screen.  This
  824.                          will continue until a key is pressed.  Fixed
  825.                          a few minor interface problems in LOCK as well.
  826.                          For instance, when pressing the <Esc> key to
  827.                          type the password, if <Esc> is pressed again,
  828.                          LOCK does not display the "Invalid Password"
  829.                          message.
  830.  
  831.                          A problem in PASSWORD was fixed that caused the
  832.                          "Minimum Password" error box to remain on the
  833.                          screen.
  834.  
  835.                          The minimum password length no longer appears
  836.                          when typing the OLD password in PASSWORD.
  837.  
  838.                          Changed a parameter in PASSWORD that allows you
  839.                          to specify the drive:path\filename of the
  840.                          password log file.  For instance:
  841.  
  842.                          LANTools Password /f /l=g:\anything\new.dat
  843. =========================================================================
  844. 07-16-91       2.00      New Version 2.00
  845.  
  846.                          ATTACH did not work.  It probably never worked,
  847.                          but I did not hear anything about it, and there
  848.                          is just one server in our office so it went
  849.                          unnoticed.  This new version takes care of all
  850.                          the problems this program had.  In addition to
  851.                          the Bug fixes, the password field is blanked out
  852.                          like other password fields.
  853.  
  854.                          The most important feature of this new release
  855.                          is in the SEND and CAPTURE commands.  Both
  856.                          of these new commands now support multi-server
  857.                          environments.  If you need to capture to a
  858.                          printer on a different server, or send a
  859.                          message to a user on a remote server, you no
  860.                          longer need to make that your default server.
  861.  
  862.                          SEND now allows users with Supervisor
  863.                          equivalence to send "anonymous" messages.  This
  864.                          means that your user ID is not sent along with
  865.                          the message (just like BROADCAST from the
  866.                          file server).
  867.  
  868.                          CAPTURE received many other small changes, most
  869.                          have to do with Multi-Server environments.  Other
  870.                          changes include the ability to End Capture from
  871.                          any port (previously it selected only your default
  872.                          port).  Many Interface changes.
  873.  
  874.                          A new command, CheckPass has been added. This is
  875.                          a very simple utility that allows you to prompt
  876.                          the user for a password.  If entered correctly,
  877.                          a DOS ERRORLEVEL of 1 is returned.  Incorrect
  878.                          entries return a DOS ERRORLEVEL of 0.
  879. =========================================================================
  880. 07-16-91       2.01      Maintenance Release
  881.  
  882.                          A bug in SEND caused non-supervisor users to
  883.                          receive an error message after pressing the
  884.                          <Enter> key to send the message and return to DOS.
  885.                          This problem is now corrected...woops!
  886. =========================================================================
  887. 08-10-91       2.10      New Version
  888.  
  889.                          A typo disabled the Multi-Server functions.
  890.                          They're back!
  891.  
  892.                          PASSWORD got a few cosmetic changes.  For one,
  893.                          the opening screen displays a brief message
  894.                          about changing your password.  A bug in the
  895.                          date logic caused the program to ignore when
  896.                          a user's password was about to expire.  The
  897.                          program now checks the password expiration
  898.                          date, and if it's within 4 days, a prompt
  899.                          displays to change it..
  900.  
  901.                          The Yes/No dialog boxes would not accept the
  902.                          "Y" or "N" keys as valid responses.  They
  903.                          do now...
  904.  
  905.                          Is there anyone out there?  Please tell us if
  906.                          you like this program, or even if you don't.
  907.                          We'd like to know!
  908. =========================================================================
  909. 08-13-91       2.20      New Version
  910.  
  911.                          A new command, DEFAULTQ has been added.  This
  912.                          command allows you to set up default print
  913.                          queues for each user, then execute them
  914.                          in the login process or any other time. Please
  915.                          see the section "DEFAULTQ" above for more
  916.                          information on this command.
  917.  
  918. =========================================================================
  919. 08-15-91       2.21      Maintenance Release
  920.  
  921.                          DefaultQ had some problems, as expected in any
  922.                          new command.  The command checks for SUPERVISOR
  923.                          equivalence to install the program.  However, our
  924.                          logic was not right, and no one could install
  925.                          the default print queues...yikes!
  926.  
  927.                          In the proces of fixing DefaultQ, we added a
  928.                          new parameter to the command, /U.  This allows
  929.                          you to Un-Install DefaultQ should you decide
  930.                          to use another method of obtaining the user's
  931.                          default print queue.
  932.  
  933.  
  934. =========================================================================
  935.  
  936.                                ╒════════════╕
  937.                                │ Known Bugs │
  938.                                ╘════════════╛
  939.  
  940. No program is bug free.  We try to make programs that do their job, but
  941. some bugs inevitably crawl into programs.  That's a fact of life.  If you
  942. find a bug, please let us know so we can correct it.  The following is
  943. a list of bugs we know about and are working to correct:
  944.  
  945. ATTACH - In Netware 386, if you do not use the command "SET UNENCRYPTED
  946. PASSWORDS = OFF", ATTACH will not work.  I would not recommend that you
  947. set this option at the file server just to use ATTACH, since Netware's
  948. security may be compromised if you do.  If you are using pre 3.00 shells,
  949. or are using Netware 286 version 2.1x, then you are already allowing
  950. unecrypted passwords, and you will not notice this problem.  We are
  951. working on this one...
  952.  
  953. PASSWORD - In Netware 386, if you are using Encrypted Passwords, PASSWORD
  954. will not work.  Password will flag you that the server is encrypted,
  955. and the password will not be changed.  Basically same as ATTACH...
  956.  
  957.  
  958.                                  ╒════════╕
  959.                                  │ Notice │
  960.                                  ╘════════╛
  961.  
  962.               Netware is a trademark of Novell, Incorporated.
  963.      IBM is a trademark of International Business Machines, Incorporated.
  964.  All other trademarks mentioned are trademarks of their respective companies.
  965.